home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Source Code / Think Class Libraries / PixelWorld classes 1.2 / CPixelWorldPane.info < prev   
Encoding:
Text File  |  1994-11-30  |  4.3 KB  |  115 lines  |  [TEXT/KAHL]
  1.                        The PixelWorldPane Class
  2.                        ------------------------
  3.                              Version 1.2
  4.  
  5.                         SUPERCLASS = CPanorama
  6.  
  7.  
  8. 1) Description
  9.     
  10.     The CPixelWorldPane class is a subclass of CPanorama that uses a 
  11.     CPixelWorld object to display a color or grayscale image that is 
  12.     kept offscreen.  An offscreen color graphics device (GDevice) and an 
  13.     offscreen color graphics port (CGrafPort) are used to maintain this 
  14.     offscreen world.  This implementation supports 1,2,4 and 8 bit pixel 
  15.     depths.  Pixel depths of 16 and 32 bits are not currently supported.  
  16.     since the current implementation of CPixelWorld 
  17.     
  18.     This implementation does not depend upon any 32-Bit QuickDraw features.  
  19.     Future versions of the CPixelWorld class will provide support for pixel 
  20.     depths of 16 and 32 bits, and for GWorlds under 32-Bit QuickDraw.  
  21.     
  22.     
  23. 2) Creating a PixelWorldPane
  24.     
  25.     After creating an instance of the CPixelWorldPane class, initialize the 
  26.     pane by calling the IPixelWorldPane method with the same parameters 
  27.     that are normally passed to IPane when initializing a CPane object.  
  28.     You must provide two additional parameters as follows:
  29.     
  30.     i)    LongRect *aBounds
  31.     
  32.         The bounds rectangle for the offscreen world.
  33.     
  34.     ii)    CPixelWorld *aPixelWorld
  35.     
  36.         This is the PixelWorld which will be used to maintain the 
  37.         offscreen image.  You can create the PixelWorld yourself with
  38.         your own image and color table, or have a blank world created 
  39.         for you by passing NULL.  If you pass NULL, the pixel depth of the 
  40.         blank world will be set to the maximum pixel depth of all screens
  41.         that are currently active on your system.  A default color table 
  42.         for that pixel depth will be used for the new PixelWorld.  
  43.     
  44.     
  45. 3) Accessing the associated PixelWorld
  46.     
  47.     The GetPixelWorld method returns a reference to the CPixelWorld
  48.     associated with your CPixelWorldPane.  
  49.     
  50.     
  51. 4) Changing to a different PixelWorld
  52.     
  53.     The SetPixelWorld method allows you to assign a different CPixelWorld 
  54.     to your CPixelWorldPane.  First, you should call GetPixelWorld to get 
  55.     the current CPixelWorld assigned to your pane.  You must dispose of 
  56.     this CPixelWorld yourself.  Then you may call the SetPixelWorld method 
  57.     to assign a different CPixelWorld to your pane.  
  58.     
  59.     
  60. 5) History
  61.     
  62.     • Version 1.0
  63.     
  64.         Date:            January 1, 1992
  65.         Author:            Vincent R. Vann, Jr.
  66.         Address:        1901 Brickell Ave, B-410, Miami, FL 33129 (USA)
  67.         Internet:        vvann@umbio.med.miami.edu
  68.         Compuserve:        76530,1242
  69.     
  70.     • Version 1.1 (This version number was skipped)
  71.         
  72.     • Version 1.2
  73.     
  74.         Date:            June 15, 1992
  75.         Author:            Vincent R. Vann, Jr.
  76.         
  77.         Changes:
  78.         [
  79.             - changed class definition to make the superclass CPanorama 
  80.               instead of CBitMapPane as in the original implementation.  
  81.             - modified the SetPixelWorld method so that the bounds, position, 
  82.               and origin of the PixelWorldPane are changed to reflect the 
  83.               new PixelWorld's coordinates.  This method also refreshes the 
  84.               pane so that the image of the new PixelWorld will be drawn.  
  85.         ]
  86.     
  87.     
  88. 6) License Agreement
  89.     
  90.     All portions of this source code are property of Vincent R. Vann, Jr.
  91.     I, Vincent R. Vann, Jr., grant you the right to freely distribute this 
  92.     source code and to use all or part of this source code in all software  
  93.     including commercial, freeware, shareware and private applications.  
  94.     However, all software that uses any part of or all of this source code 
  95.     must display a copyright notice indicating that either all of or 
  96.     portions of this source code are used in the software.  I also grant 
  97.     you permission to alter and make improvements to this source code, but 
  98.     only if all modifications are returned to me by whatever means are 
  99.     available, either in written or electronic form.  You must also accept 
  100.     that I retain the right to include any part of your modifications or 
  101.     all of your modifications in future releases of this source code.  The 
  102.     description and version history sections of the *.info files may be 
  103.     ammended for documentation purposes.  This license agreement and the 
  104.     copyright notice below must be maintained intact and must be included 
  105.     with all distributions of this source code at all times.  
  106.     
  107.     
  108. 7) Copyright Notice
  109.     
  110.     This implementation is based in part on material copyrighted by 
  111.     Symantec Corporation and Apple Computer, Inc.  
  112.     
  113.     Copyright © 1992 Vincent R. Vann, Jr.  All rights reserved.  
  114.     
  115.